home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / man / cmds.fmt / jaquith.man < prev    next >
Encoding:
Text File  |  1992-08-28  |  10.9 KB  |  331 lines
  1.  
  2.  
  3.  
  4. JAQUITH                   User Commands                   JAQUITH
  5.  
  6.  
  7.  
  8. _________________________________________________________________
  9.  
  10. NNAAMMEE
  11.      jaquith - Tertiary storage manager
  12.  
  13. SSYYNNOOPPSSIISS
  14.      jjaaqquuiitthh  [--ppoorrtt _p_o_r_t] [--llooggffiillee _l_o_g_f_i_l_e] [--llooggddeettaaiill  _l_e_v_e_l]
  15.      [--rroooott _r_o_o_t_n_a_m_e] [--ppuutteexxeecc _f_i_l_e_n_a_m_e]
  16.      [--ggeetteexxeecc _f_i_l_e_n_a_m_e] [--cclleeaanneexxeecc  _f_i_l_e_n_a_m_e]  [--ddiisskkhhiigghh  _p_e_r_-
  17.      _c_e_n_t] [--ddiisskkllooww _p_e_r_c_e_n_t] [--nneettmmaasskk _m_a_s_k]
  18.      [--ffssyynnccffrreeqq _c_o_u_n_t] [--cchhiillddddbbgg]]
  19.  
  20. OOPPTTIIOONNSS
  21.      --ppoorrtt _p_o_r_t    Port number where jaquith  should  listen  for
  22.                    new connections.  Defaults to 10001 (decimal).
  23.  
  24.      --llooggffiillee _l_o_g_f_i_l_e
  25.                    Enable activity logging to specified file
  26.  
  27.      --llooggddeettaaiill _d_e_t_a_i_l
  28.                    Amount of logging information. There are  four
  29.                    levels,  with  high levels including the lower
  30.                    ones.  0x0 == None.  0x01  =  errors.  0x02  =
  31.                    major  events.   0x04  =  minor events. 0x08 =
  32.                    code tracing.
  33.  
  34.      --rroooott _r_o_o_t_n_a_m_e
  35.                    Root of index tree
  36.  
  37.      --ppuutteexxeecc _f_i_l_e_n_a_m_e
  38.                    Path to Jaquith update  program.  Defaults  to
  39.                    /usr/bin/jupdate.
  40.  
  41.      --ggeetteexxeecc _f_i_l_e_n_a_m_e
  42.                    Path to Jaquith retrieval program. Defaults to
  43.                    /usr/bin/jfetch.
  44.  
  45.      --cclleeaanneexxeecc _f_i_l_e_n_a_m_e
  46.                    Path to Jaquith cleaner program.  Defaults  to
  47.                    /usr/bin/jclean.
  48.  
  49.      --ddiisskkhhiigghh _p_e_r_c_e_n_t
  50.                    Disk  threshold  at  which  cleaner  will   be
  51.                    invoked  to  free  disk  space by copying data
  52.                    buffers to tape.
  53.  
  54.      --ddiisskkllooww _p_e_r_c_e_n_t
  55.                    Disk threshold at which cleaner will stop try-
  56.                    ing to free disk space by copying data buffers
  57.                    to tape.
  58.  
  59.      --nneettmmaasskk _m_a_s_k Refuse  service  to  clients  whose   internet
  60.  
  61.  
  62.  
  63. Sprite v1.0                                                     1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. JAQUITH                   User Commands                   JAQUITH
  71.  
  72.  
  73.  
  74.                    address doesn't match _m_a_s_k. The mask is speci-
  75.                    fied in the form "128.32.1.2".  A "*"  can  be
  76.                    substituted  for a number to accept all values
  77.                    in that position.
  78.  
  79.      --ffssyynnccffrreeqq _c_o_u_n_t
  80.                    For jput  operations,  force  an  fsync  every
  81.                    _c_o_u_n_t files.  Default is 10.
  82.  
  83.      --cchhiillddddbbgg     Invoke update  and  retrieval  processes  with
  84.                    -debug flag.
  85. _________________________________________________________________
  86.  
  87. DDEESSCCRRIIPPTTIIOONN
  88.      The JJaaqquuiitthh system is a tertiary storage manager which  pro-
  89.      vides  storage,  indexing  and retrieval services to network
  90.      clients.
  91.  
  92.  
  93.      This man page describes JJaaqquuiitthh, the main server. The  other
  94.      parts of the system include:
  95.  
  96.  
  97.           jmgr   -- the jukebox manager
  98.           jclean -- the archive cleaner
  99.           jput, jget, jls, jstat -- Client utilities
  100.           jupdate, jfetch, jquery -- Jaquith servant processes
  101.           jcopy, jctrl, jbuild -- System administration utilities
  102.  
  103.      The jaquith process is the primary server  for  the  Jaquith
  104.      archive  system.   It  listens on a public port for incoming
  105.      client requests and spawns child processes to  handle  those
  106.      requests.  The port is specified with the --ppoorrtt option. Each
  107.      jjppuutt request spawns a _w_r_i_t_e_r as specified with the  --ppuutteexxeecc
  108.      option. Similarly, each jjggeett or jls request spawns a _r_e_a_d_e_r.
  109.      jjssttaatt requests spawn _q_u_e_r_y processes.
  110.  
  111.  
  112.      Jaquith also spawns a _c_l_e_a_n_e_r process which writes data from
  113.      disk  to  tertiary  storage,  as  necessary.  The cleaner is
  114.      specified with the  --cclleeaanneexxeecc  option,  and  the  threshold
  115.      which controls its invocation is specified with the -disklow
  116.      and --ddiisskkhhiigghh options. DDiisskkHHiigghh gives the level of disk use,
  117.      in  percent, when the cleaner should be invoked. The cleaner
  118.      will clean the disk down to the low water mark, --ddiisskkllooww.
  119.  
  120.  
  121.      Jaquith assumes the presence of the jukebox manager, a  pro-
  122.      cess which mediates access to the physical jukebox. See jmgr
  123.      for details.
  124.  
  125.  
  126.  
  127.  
  128.  
  129. Sprite v1.0                                                     2
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. JAQUITH                   User Commands                   JAQUITH
  137.  
  138.  
  139.  
  140.      To install Jaquith initially, create a directory to  act  as
  141.      the  Jaquith  root,  typically  /jaquith.  It's  easiest  if
  142.      DEF_ROOT (in jaquith.h) is set to this name and all the pro-
  143.      grams  are  recompiled.  Then create volconfig and devconfig
  144.      files for jmgr. Start jaquith and jmgr and you're set.
  145.  
  146.  
  147.      To grant access to Jaquith to a new user, create a new logi-
  148.      cal  archive,  if desired, by creating a subdirectory in the
  149.      Jaquith root called _a_r_c_h_N_a_m_e..aarrcchh.   In  this  subdirectory,
  150.      create the aauutthh file, as described in the RELATED FILES sec-
  151.      tion, or just add the user  to  the  existing  authorization
  152.      file.
  153.  
  154.  
  155. RREELLAATTEEDD FFIILLEESS
  156.      Jaquith maintains a number of files describing the state  of
  157.      the  physical and logical archive. All of these files reside
  158.      in the Jaquith root (usually /arch  but  settable  with  the
  159.      -root flag).
  160.  
  161.      ffrreeeevvoollss      The global pool of available  volumes.   These
  162.                    will be consumed as needed by the cleaner pro-
  163.                    cess. Format of an entry is  just  the  volume
  164.                    ID.
  165.  
  166.      ddeevvccoonnffiigg     The list of device names to be  controlled  by
  167.                    the  jukebox  manager.   Format is device name
  168.                    followed by its slot in the jukebox.
  169.  
  170.      vvoollccoonnffiigg     The list of volumes and their  slot  locations
  171.                    in the jukebox. Format is the volume name fol-
  172.                    lowed by its slot in the jukebox.
  173.  
  174.      ttbbuuff..llrruu      The global  least-recently-used  buffer  list.
  175.                    Buffers  at the top of the list are prime can-
  176.                    didates for removal if disk  space  is  tight.
  177.                    Format  is  logical  archive  name followed by
  178.                    tbuf number.
  179.  
  180.      rreebbuuiilldd.._p_i_d   Temporary work file created by jjbbuuiilldd.
  181.  
  182.      tthhddrr.._p_i_d._n_u_m  Emergency work file created by jjbbuuiilldd when  it
  183.                    can't parse the thdr file it got from tape.
  184.  
  185.      _a_r_c_h_i_v_e//ccoonnffiigg
  186.                    Archive configuration information.  Format  is
  187.                    jmgr  server  name and port number followed by
  188.                    desired buffer size.
  189.  
  190.      _a_r_c_h_i_v_e//ttbbuuff  Current buffer number. I.E. current buffer  is
  191.                    ttbbuuff.._n_u_m.
  192.  
  193.  
  194.  
  195. Sprite v1.0                                                     3
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. JAQUITH                   User Commands                   JAQUITH
  203.  
  204.  
  205.  
  206.      _a_r_c_h_i_v_e//ttbbuuff.._n_u_m
  207.                    Tape buffer files. These  files  contain  user
  208.                    file data in Posix tar format.
  209.  
  210.      _a_r_c_h_i_v_e//tthhddrr.._n_u_m
  211.                    Tape header files.  These  files  contain  the
  212.                    indexing  information  in  case the disk index
  213.                    structure is destroyed.
  214.  
  215.      _a_r_c_h_i_v_e//mmeettaa.._n_u_m
  216.                    Meta  information  about  tbuf._n_u_m  maintained
  217.                    while buffer is being built in case of crash.
  218.  
  219.      _a_r_c_h_i_v_e//lloogg   The  list  of  operations  which   have   been
  220.                    requested on this logical archive.
  221.  
  222.      _a_r_c_h_i_v_e//ffiilleemmaapp
  223.                    The list of volumes assigned to  this  archive
  224.                    along  with  the starting buffer number on the
  225.                    volume and the date the volume was assigned.
  226.  
  227.      _a_r_c_h_i_v_e//aauutthh  The authorization information for the  logical
  228.                    archive.  The  file  consists  of  single-line
  229.                    entries in no particular order. Each entry has
  230.                    the  form  _u_s_e_r_n_a_m_e _g_r_o_u_p_n_a_m_e _h_o_s_t_n_a_m_e _p_e_r_m_i_s_-
  231.                    _s_i_o_n.  _u_s_e_r_n_a_m_e, _g_r_o_u_p_n_a_m_e, and  _h_o_s_t_n_a_m_e  are
  232.                    globbing  expressions.  _P_e_r_m_i_s_s_i_o_n is RR, WW, or
  233.                    OO  for  read,  read-and-write   or   ownership
  234.                    respectively.  Ownership means that the speci-
  235.                    fied user or group has 'root' access  to  this
  236.                    logical archive. Client requests are validated
  237.                    by  first  looking  for  an   entry   with   a
  238.                    corresponding user name. If none is found then
  239.                    an entry with a matching group name  is  used,
  240.                    else permission is denied.
  241.  
  242.      _a_r_c_h_i_v_e//vvoolliinnffoo
  243.                    Physical volume information for  this  logical
  244.                    archive.  Entries are: current volume id, next
  245.                    location on volume where buffer is to be writ-
  246.                    ten,  remaining  space  in  KB on volume, last
  247.                    buffer number written, current buffer number.
  248.  
  249.      _a_r_c_h_i_v_e//ttbbuuffiinnffoo
  250.                    Current buffer information  for  this  logical
  251.                    archive.  Entries  are:  buffer size in bytes,
  252.                    buffer header size in bytes,  number  of  user
  253.                    files in buffer.
  254.  
  255. BBUUGGSS
  256.      None. Jaquith is perfection personified.
  257.  
  258.  
  259.  
  260.  
  261. Sprite v1.0                                                     4
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268. JAQUITH                   User Commands                   JAQUITH
  269.  
  270.  
  271.  
  272. SSEEEE AALLSSOO
  273.      jmgr jls jstat jput jget jctrl jcopy jclean jbuild
  274.  
  275.  
  276. KKEEYYWWOORRDDSS
  277.      jaquith archive
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327. Sprite v1.0                                                     5
  328.  
  329.  
  330.  
  331.